home *** CD-ROM | disk | FTP | other *** search
/ Tech Arsenal 1 / Tech Arsenal (Arsenal Computer).ISO / tek-06 / lantoo.zip / LANTOOLS.DOC < prev    next >
Text File  |  1991-08-14  |  41KB  |  913 lines

  1.                          Devont Software's
  2.                        LANTools Version 1.0
  3.                             May 3, 1991
  4.  
  5.                          ╒══════════════╕
  6.                          │ Introduction │
  7.                          ╘══════════════╛
  8. As a Systems Administrator or one who creates networks for a
  9. living, you probably already know that the glue that holds these
  10. complex systems together is the little Batch files and utilities.
  11. Devont Software's LANTools is a collection of such utilities
  12. designed to make your life a little easier.
  13.  
  14.                          ╒══════════════╕
  15.                          │ Requirements │
  16.                          ╘══════════════╛
  17. Most of the functions in LANTools operate directly with the Novell
  18. Bindery information.  Because of this integration with Netware,
  19. LANTools will not work on any other network type, or on stand-alone
  20. machines.  Besides that small requirement, you should have the
  21. following resources available:
  22.  
  23.  
  24. √    IBM Personal Computer or Compatible.
  25.  
  26. √    256K RAM Free or more
  27.  
  28. √    VGA, EGA, CGA, Mono, or Hercules Monitors are supported
  29.  
  30. √    Novell Netware 2.1x and above, or ELS versions (versions below
  31.      2.1x may not support the printing functions)
  32.  
  33.                    ╒══════════════════════════╕
  34.                    │ Registration and Support │
  35.                    ╘══════════════════════════╛
  36. LANTools is not free software.  If is not and will never be in the
  37. public domain.  You are granted a limited license to test the program
  38. to see if it fits in your environment.  If you use any of the utilities
  39. contained in this package after a 30 day trial period, you need to
  40. support our development efforts by sending a check or money order
  41. for $75.00 per site in US Funds to:
  42.  
  43.                          Devont Software
  44.                            85 Brandon
  45.                        Conroe, Texas 77302
  46.                       BBS - (409) 273-3112
  47.                         CIS: 70421,1506
  48.  
  49. Technical support and upgrades are available by calling our Technical
  50. Support Bulletin Board (BBS).  We are open 24 hours a day, 7 days a
  51. week, and support 300-2400bps.  We would like to hear from you if you
  52. have any suggestions, improvement ideas, customization requests or
  53. complaints.  We take them all.  You can call our tech support
  54. telephone number between the hours of 7pm and 10pm CST.  We would like
  55. to hear from you.  (409) 321-3220.  Weekends from noon to 7pm CST.
  56.  
  57.                           ╒═════════════╕
  58.                           │ Conventions │
  59.                           ╘═════════════╛
  60. In the functional descriptions below, the following conventions are
  61. used:
  62.  
  63. [option]       Options enclosed in brackets are optional.
  64. /x=            Lettered options are required parameters.
  65. FILESPEC       Any file specification, such as *.EXE, z:\joe.txt
  66. FILE.EXT       Any valid Filename, such as z:\public\joe.txt
  67.  
  68.  
  69.                          ╒═════════════════╕
  70.                          │ LANTools Attach │
  71.                          ╘═════════════════╛
  72.  
  73. Description:   LANTools Attach is functionally equivalent to Netware's
  74.                ATTACH command, with the major difference in that
  75.                the interface is much prettier.  Users can select a
  76.                file server that is not already attached by using a
  77.                bouncebar menu.  Attach prompts the user for
  78.                required information, and tells them whether the
  79.                attachment was successful.
  80.  
  81. Use:           LANTools Attach [/q]
  82.  
  83. Parameters
  84.  
  85. /q             Use "Quiet Mode."  Do not clear the screen after
  86.                the program has completed.
  87.  
  88. /c             (Color - Optional) Select a color from 1 -4
  89.  
  90.  
  91.                    ╒══════════════════════════╕
  92.                    │ LANTools Bulletin Master │
  93.                    ╘══════════════════════════╛
  94.  
  95. Description:   LANTools BBS allows the system administrator to set
  96.                up ASCII text files, then display them to particular
  97.                groups of users upon login, or from a menu item.
  98.                Using this feature, you can notify your users of any
  99.                events, procedures, or policies.
  100.  
  101.                If you specify multiple text files, BBS will
  102.                display a bouncebar menu of available bulletins,
  103.                and will allow the user to point and shoot the
  104.                bulletins he wants to read.
  105.  
  106. Use:           BBS /f=FILESPEC [/g=GROUP,GROUP,GROUP] [/q]
  107.  
  108. Example:       LANTools BBS /f=z:*.bbs /g=ADMIN,TECH
  109.  
  110. Parameters
  111.  
  112. /f             (Filespec - Required)  Can be any filename, or group
  113.                of files. You can add any fully qualified pathname, one
  114.                filename, etc.
  115.  
  116. /g             (Groups - Optional)  BBS will check to see that the user
  117.                running the program is a member of this group (or
  118.                several groups separated by a comma) if this
  119.                optional parameter is used.  If you do not specify
  120.                a group, BBS will assume EVERYONE can read the
  121.                bulletins specified.
  122.  
  123. /q             (Quiet Mode - optional):  Do not display any message
  124.                if no bulletin files are available.
  125.  
  126. /c             (Color - Optional) Select a color from 1 -4
  127.  
  128.  
  129. Text File      When creating a text file for display in BBS, the
  130.   Notes        very first line can contain a title.   To display
  131.                the title when multiple text files are available,
  132.                use the following format:
  133.  
  134.                ^^This is the Title^^
  135.                ..Rest of ASCII text file
  136.  
  137.                             ╒══════════════════╕
  138.                             │ LANTools Capture │
  139.                             ╘══════════════════╛
  140.  
  141. Description:   LANTools Capture is functionally equivalent to
  142.                Netware's CAPTURE command.  With LANTools Capture,
  143.                you can redirect your LPT1-4's output to any
  144.                defined network queue, or end a capture session,
  145.                and return print operations to a local printer.
  146.                Capture does all this with complete error checking
  147.                and friendly interfacing.
  148.  
  149.                If you are attached to multiple servers (via
  150.                Netware's ATTACH or LANTools' ATTACH command), you
  151.                can press the <Spacebar> while viewing the Print
  152.                Queue listing to change to the next server.  You can
  153.                then capture to a queue on another server.
  154.  
  155. Use:           LANTools Capture [/q]
  156.  
  157. Parameters:
  158.  
  159. /q             (Quiet Mode - optional):  Do not clear the screen
  160.                when the program completes.
  161.  
  162. /c             (Color - Optional) Select a color from 1 -4
  163.  
  164.                             ╒════════════════════╕
  165.                             │ LANTools CheckPass │
  166.                             ╘════════════════════╛
  167.  
  168. Description:   LANTools CheckPass is a simple utility that allows you to
  169.                prompt the user for a password.  If the correct password
  170.                is entered, a DOS ERRORLEVEL of 1 is returned.  Incorrect
  171.                passwords return a DOS ERRORLEVEL of 0.
  172.  
  173. Parameters:
  174.  
  175. /p=Password    (Required Parameter):  This parameter tells CheckPass what
  176.                the correct password is.  Not case sensitive.
  177.  
  178. /c              (Color - Optional) Select a color from 1 - 4.
  179.  
  180. /q              (Quiet Mode - Optional):  Do not clear the screen when the
  181.                 program completes.
  182.  
  183.  
  184.                            ╒═══════════════════╕
  185.                            │ LANTools DefaultQ │
  186.                            ╘═══════════════════╛
  187.  
  188. Description:   LANTools Default-Q allows you to set up default print
  189.                queues for each user, then automatically cature to
  190.                that queue upon login or any other time.
  191.  
  192.                DefaultQ uses the same parameters as Novell's CAPTURE
  193.                program to change the settings of the current Capture
  194.                setting, but using the queue that the Supervisor or
  195.                user has set up.
  196.  
  197.                The unique parameter to DefaultQ is /C.  This parameter
  198.                is used to configure DefaultQ.
  199.  
  200. RETURNS        If used as a CAPTURE command, DOS ERRORLEVEL of 0 is
  201.                returned if the capture environment is not changed.
  202.                Otherwise, ERRORLEVEL of 1 is returned.
  203.  
  204. Use:   LANTools DefaultQ  [/c] [ /b=BannerTxt /nb /ff /nff /ti=n /a /f=n ... ]
  205.  
  206.  
  207. PARAMETERS      /c  Configure DefaultQ
  208.  
  209.                 Other Parameters supported are the same as Novell's CAPTURE
  210.                 command, such as /b=BannerText, /nb, /ti=3, /nff (etc.)
  211.  
  212.  
  213.                                 Why Use DefaultQ
  214.  
  215. Let's say you are running a network with about 20 printers, and 50 users.
  216. If you would like to automatically run a CAPTURE statement on each user
  217. in the login process, you have roughly four choices:
  218.  
  219. 1.  Create a User Login Script and run the #CAPTURE statement.  This is
  220.     fine for smaller networks, but who wants to maintain all those user
  221.     Login Scripts?  It's usually a good idea to avoid using them if at
  222.     all possible.
  223.  
  224. 2.  Allow the user to create his own personal print queue and defaults
  225.     using the PRINTCON program.  This is a good way to do it, but who
  226.     wants to explain the inner workings of the Netware print services
  227.     and/or print options to a legal secretary?  You'd probably end up
  228.     creating a bunch of them yourself, or copying the same definition
  229.     from one user to the other, limiting the customizability, and in
  230.     the end you'll have to edit all these over again someday when they
  231.     move down the hall to a new office.
  232.  
  233. 3.  Create a Group the same name as the name of the print queue, then
  234.     make all the users who need to print to that printer a member of this
  235.     new group.  You could then test for membership to the printer groups
  236.     in the login script, and do some nifty branching.  Well, again, if
  237.     you have 20 printers, that's an extra 20 groups, and 20 different
  238.     tests in the System Login script you'd have to make to see which
  239.     group they are a member of....not to mention the chance for errors
  240.     in putting all the right users in all the right places.
  241.  
  242. 4.  You could create a file, add all the UserIDs and their default print
  243.     queue next to it, then write a simple program that looks at the
  244.     file one entry at a time, reads the name, the print queue, and then
  245.     does something fancy to actually call the CAPTURE routines in
  246.     Netware.  Big pain.  Plus, you've then got a file to maintain.
  247.  
  248.  
  249.                           How Does DefaultQ Work?
  250.  
  251. DefaultQ uses standard Netware services to write to the user data file,
  252. known as the Bindery.  DefaultQ stores one vital peice of information
  253. next to the user account property:  The default print name that either
  254. you or he set up.  If DefaultQ has never been configured for a particular
  255. user, then nothing is written to that user account.
  256.  
  257. After DefaultQ has been set up for a user, they can execute the
  258. DefaultQ command. The program picks up the name of the default print
  259. queue, any valid CAPTURE parameters entered along with the basic command,
  260. then again uses standard Netware services to create the CAPTURE environment.
  261.  
  262. If DefultQ has not been set up for a user and it is run like a CAPTURE
  263. command, a DOS ERRORLEVEL 0 is returned, and the CAPTURE environment is
  264. not affected.
  265.  
  266.  
  267.  
  268.  
  269.                            ╒═══════════════════╕
  270.                            │ LANTools IsMember │
  271.                            ╘═══════════════════╛
  272.  
  273. Description:   LANTools IsMember is a batch file enhancer.  This
  274.                utility allows you to determine if a user is a
  275.                member of a particular group.  LANTools IsMember
  276.                returns a DOS ERRORLEVEL that you can test and
  277.                perform conditional branching.
  278.  
  279. Use:           LANTools IsMember /g=GROUP1,GROUP2
  280.  
  281. Parameters:
  282.  
  283. /g             (Group(s) - Required) Specify the group (or groups
  284.                separated with a comma) to check.
  285.  
  286. /q             (Quiet Mode - optional):  Do not clear the screen
  287.                when the program completes.
  288.  
  289. /c             (Color - Optional) Select a color from 1 -4
  290.  
  291. Returns:       ERRORLEVEL 1 = User is a member of at least one of the
  292.                specified groups.
  293.  
  294.                ERRORLEVEL 0 = User is NOT a member of at least one of the
  295.                specified group(s).
  296.  
  297.  
  298.                             ╒═══════════════╕
  299.                             │ LANTools List │
  300.                             ╘═══════════════╛
  301.  
  302. Description:   LANTools List is a simple file viewer for ASCII
  303.                text files.  I'm sure you have seen programs like
  304.                LIST, BROWSE, or maybe you have written your own.
  305.                This program is a simple version of those, but in a
  306.                form that even the most computer-illiterate users
  307.                can use without getting overly confused.  In
  308.                addition, this program follows the other LANTools
  309.                in the interface, giving your system a colorful,
  310.                fluid feel.
  311.  
  312. Use:           LANTools List [/f=FILE.EXT] [/q] [/c=1-4]
  313.  
  314. Parameters
  315.  
  316. /f             (FileName - Optional Parameter): any valid file
  317.                name, such as Z:FRED.TXT.  If the file does not
  318.                exist, a message displays.  Note also the text file
  319.                to display is limited to 64K.  If a filename is
  320.                not specified, you are prompted to enter one.
  321.  
  322. /q             (Quiet Mode - optional):  Do not clear the screen
  323.                when the program finishes.
  324.  
  325. /c             (Color - Optional) Select a color from 1 -4
  326.  
  327.                                 ╒═══════════════╕
  328.                                 │ LANTools Lock │
  329.                                 ╘═══════════════╛
  330.  
  331. Description:   LANTools Lock allows you to lock your computer
  332.                while you are away at lunch or away from your desk.
  333.                You can display a brief message to those who come
  334.                to your desk and look at your screen.  Lock also
  335.                comes with a screen blanker that will activate
  336.                after a period of about 5 minutes.  Pressing a key
  337.                while the blanker is in effect restores the screen.
  338.  
  339. Use:           LANTools Lock [/m="Message Text"] [/p] [/q]
  340.  
  341. Parameters:
  342.  
  343. /m             (Message Text - Optional) Message to display when
  344.                your machine is locked.  If this parameter is not
  345.                specified, you will be prompted to enter this
  346.                information.
  347.  
  348. /p             (Password - Optional)  Password that will be used
  349.                to unlock your keyboard.  If you do not specify
  350.                this parameter, you will be prompted to enter this
  351.                information.  Maximum password length is 8 characters.
  352.  
  353. /q             (Quiet Mode - Optional) do not clear the screen
  354.                when the program has completed.
  355.  
  356. /c             (Color - Optional) Select a color from 1 -4
  357.  
  358.                                ╒═════════════════╕
  359.                                │ LANTools Logout │
  360.                                ╘═════════════════╛
  361.  
  362. Description:   LANTools Logout is functionally equivalent to
  363.                Netware's LOGOUT.EXE.  The difference is in the
  364.                interface. LANTools Logout allows you to prompt the
  365.                user with a colorful message, then reboot
  366.                (optionally) the machine when a specified time
  367.                period, or press of the enter key has been
  368.                performed.
  369.  
  370.  
  371. Use:           LANTools LOGOUT [/m="MESSAGE TEXT"] [/w=n] [/r] [/q]
  372.  
  373. Parameters
  374.  
  375. /m             (Message Text - Optional): Use this parameter if you
  376.                would like to display a message to the user after he
  377.                has logged out.  Note that when specifying a message,
  378.                you must use the " marks surrounding the message
  379.                text.  If you do not specify a message, a generic
  380.                "You Have Been Logged Out" displays.
  381.  
  382.                You can place a carat (^) in your text to display
  383.                two lines of text to the user.  For instance:
  384.                LANTools Logout /m="You Are logged out^Thank You!"
  385.  
  386.                You are limited to displaying two lines of text.
  387.                Each line of text can contain up to 60 characters.
  388.  
  389. /w             (Wait time - Optional):  Amount of time to wait before
  390.                ending the program.  If not specified, 0 is assumed, which
  391.                means to wait until <Enter> is pressed.
  392.  
  393. /r             (Reboot - Optional): Reboot the computer when the
  394.                program completes.
  395.  
  396. /q             (Quiet Mode - Optional):  Do not clear the screen when
  397.                the program is finished.
  398.  
  399. /c             (Color - Optional) Select a color from 1 -4
  400.  
  401.                                    ╒═══════════════╕
  402.                                    │ LANTools Menu │
  403.                                    ╘═══════════════╛
  404.  
  405. Description:  LANTools Menu is a simple menu builder.  You can create
  406.               a standard ASCII text file, and Menu will display the
  407.               menu items in a formatted screen.
  408.  
  409.  
  410. Use:          LANTools Menu /f=FileSpec [/c=1-4] [/q]
  411.  
  412. Returns:      DOS Errorlevel (0=ESC was pressed, 1=Item 1, 2=Item 2...)
  413.  
  414. Paramters
  415.  
  416. /f            Menu File Name to read.  Example:  LANTools Menu /f=MENU.TXT
  417.  
  418.               << Contents of MENU.TXT >>
  419.  
  420.               File Management
  421.               Logout of Network
  422.               Accounting Functions
  423.               Send a Message
  424.               Select Network Printer
  425.               Attach to File Server
  426.  
  427.               If the example file above was used, the DOS ERRORLEVEL returned
  428.               would be as follows:
  429.  
  430.               0 - No Selection was made.
  431.               1 - File Management
  432.               2 - Logout
  433.               3 - Accounting
  434.               4 - Send a Message
  435.               5 - Select Network Printer
  436.               6 - Attach to File Server
  437.  
  438.               You can process this ERRORLEVEL in a batch file.  For more
  439.               information about DOS ERRORLEVELs and batch files, please
  440.               see your handy-dandy DOS manual.  Also see SAMPLE.BAT for
  441.               an example of LANTools Menu.
  442.  
  443.  
  444. /c            Color for Menu.  1-4 are accepted
  445.  
  446. /q            Do not clear the screen when finished.
  447.  
  448.  
  449.                                  ╒══════════════════╕
  450.                                  │ LANTools Message │
  451.                                  ╘══════════════════╛
  452.  
  453. Description:   LANTools Message is a simple utility that allows
  454.                you to display messages to your users in a
  455.                formatted, consistent and colorful way.  Users
  456.                do not need to have ANSI.SYS loaded, nor do you
  457.                have to check for monitor type.
  458.  
  459. Use:           LANTools Message /m="Message Text" [/w=n] [/q]
  460.  
  461. Parameters
  462.  
  463. /m             (Message Text - Required):  This parameter tells
  464.                LANTools Message what to display.  Note that the
  465.                message text must be surrounded by the quotation
  466.                (") marks.
  467.  
  468.                You can place a carat (^) in your text to tell Message
  469.                to break the text into two lines.  For instance:
  470.                LANTools Message /m="Hello There^Welcome Aboard"
  471.  
  472.                You are limited to displaying two lines of text.
  473.                Each line of text is limited to 60 characters.
  474.  
  475. /w             (Wait Time - Optional):  Tells LANTools Message how
  476.                long to wait before ending the program.  If you do
  477.                not specify a parameter, 0 is assumed, which means
  478.                to wait until <Enter> is pressed.
  479.  
  480. /q             (Quiet Mode - Optional):  Do not clear the screen
  481.                after the program ends.
  482.  
  483. /c             (Color - Optional) Select a color from 1 -4
  484.  
  485.                                ╒═══════════════════╕
  486.                                │ LANTools Password │
  487.                                ╘═══════════════════╛
  488.  
  489. Description:   LANTools Password is functionally equivalent to Netware's
  490.                SETPASS command.  It allows your users to change their
  491.                login password.  Difference is in the interface, and that
  492.                you can select to log the password to a text file.
  493.  
  494.                Run without parameters, PASSWORD checks to see if the user's
  495.                password is about to expire (within 3 days).  If so, the
  496.                user is prompted to enter his old and new password.  If
  497.                correct, the user's password is changed at the file server.
  498.  
  499.                If the /l=LOG parameter is used, PASSWORD writes all
  500.                password activity to a file called PW.LOG in the current
  501.                directory.  Be careful!  This feature is not meant for
  502.                any other reason than for the systems administrator to
  503.                track and document passwords used on his/her system.
  504.                Letting the PW.LOG file into the wrong hands, and your
  505.                system security will go down the drain.
  506.  
  507. Use:           LANTools Password [/f] [/l=FILE.EXT]
  508.  
  509.  
  510. Parameters
  511.  
  512. /f             "Force" the password change.  This could be used as a menu
  513.                selection item, so the users can change their password
  514.                whenever they want to. Without this parameter, PASSWORD
  515.                checks to see if the user's password is almost expired.
  516.                If not, the program ends.
  517.  
  518. /l             Log all password change activity into the specified file.
  519.                For example:  LANTools Password /f /l=f:\dat\pw.dat
  520.  
  521.                Note:  You should Hide the directory that contains the
  522.                password log file to keep prying eyes out of it.  Also,
  523.                remember that the users must have Write, Modify, Read
  524.                and Open rights to this directory.  If the file does
  525.                not already exist, they must also have Create rights.
  526.  
  527.                Example Rights for directory that contains pw log file:
  528.  
  529.                Netware 386 - [ R W M F   ]
  530.                Netware 286 - [ R W M O S ]
  531.  
  532.  
  533.                                  ╒═══════════════╕
  534.                                  │ LANTools Send │
  535.                                  ╘═══════════════╛
  536.  
  537. Description:   LANTools Send is functionally equivalent to
  538.                Netware's SEND.EXE.  With LANTools Send, however,
  539.                the user interface is quite a bit more friendly and
  540.                colorful.
  541.  
  542.                If you are attached to multiple servers (via Netware's
  543.                ATTACH or LANTools' ATTACH command), you can send
  544.                messages to users on other servers by using the
  545.                <Spacebar> while viewing the user list.
  546.  
  547. Use:           LANTools Send [/q]
  548.  
  549. Parameters
  550.  
  551. /q             (Quiet Mode - Optional) Do not clear the screen
  552.                after the program ends.
  553.  
  554. /c             (Color - Optional) Select a color from 1 -4
  555.  
  556.                               ╒══════════════════╕
  557.                               │ LANTools TimeOut │
  558.                               ╘══════════════════╛
  559.  
  560. Description:   LANTools TimeOut is a program that waits until a
  561.                specified time is reached, then returns a DOS
  562.                ERRORLEVEL.  The program can be aborted by entering
  563.                in a specified password, which then a different DOS
  564.                ERRORLEVEL is returned.  This returned value can be
  565.                tested in a batch file.  A common use for this
  566.                utility is in Automated Tape procedures, such as
  567.                performing an automatic backup at 02:00.
  568.  
  569.                << Example TAPE.BAT >>
  570.  
  571.                @echo off
  572.                cls
  573.                :LOOP
  574.                LANTools TimeOut /t=02:00 /p=wierd
  575.                if errorlevel 1 goto TAPE
  576.                if errorlevel 0 goto EXIT
  577.                :TAPE
  578.                tna2tape /a /q
  579.                goto LOOP
  580.                :EXIT
  581.  
  582.  
  583. Use:           LANTools TimeOut [/t=HH:MM] [/p=xxxxxxx]
  584.  
  585. Parameters
  586.  
  587. /t             (Time - Optional)  If specified, this is the time
  588.                that must be reached in order for TimeOut to end.
  589.                If not specified, you will be prompted to enter
  590.                this information.  Note:  Use 24 Hour Military
  591.                time!
  592.  
  593. /p             (Password - Optional) If specified, this is the
  594.                password needed to abort the program.  If not
  595.                specified, you will be prompted for this
  596.                information.
  597.  
  598. /q             (Quiet Mode - Optional) Do not clear the screen
  599.                after this program ends.
  600.  
  601. /c             (Color - Optional) Select a color from 1 -4
  602.  
  603.          TimeOut Returns the following DOS ERRORLEVELS:
  604.                  1 = Time Reached.
  605.                  0 = Password Entered Correctly
  606.  
  607.                              ╒═════════════════╕
  608.                              │ LANTools WhoAmI │
  609.                              ╘═════════════════╛
  610.  
  611. Description:   LANTools WhoAmI provides an informational display
  612.                containing vital information about the user who
  613.                is running it.  Information such as the password
  614.                expiration date, connection number, ID number and
  615.                current print queue selected is displayed in a
  616.                nice box in the middle of the screen.  The user
  617.                cannot change any of this information within this
  618.                function.
  619.  
  620. Use:           LANTools WhoAmI [/q] [/c=1]
  621.  
  622. Parameters
  623.  
  624. /c             (Color - Optional) Specify a color from 1 - 4
  625.  
  626. /q             (Quiet Mode - Optional) Do not clear the screen when
  627.                this function ends.
  628.  
  629.  
  630.  
  631.                              ╒═════════════════╕
  632.                              │ LANTools YesBox │
  633.                              ╘═════════════════╛
  634.  
  635. Description:   LANTools YesBox is another batch file enhancer.
  636.                With YesBox, you can place a message on the screen,
  637.                and have the user respond with the up or down arrow
  638.                keys to select either "Yes" or "No". Depending on
  639.                what the user selects, a DOS ERRORLEVEL is
  640.                returned.  This returned value can be tested in a
  641.                batch file for conditional branching.  You probably
  642.                have a utility that does this for you already, but
  643.                not as friendly and colorful as this one is!
  644.  
  645.                The user cannot break out of this prompt.  The only
  646.                valid keys while in this function are the Up and
  647.                Down arrow keys, and <Enter>.
  648.  
  649. Use:           LANTools YesBox [/m="Message Text"] [/q]
  650.  
  651. Parameters
  652.  
  653. /m             (Message Text - Optional)  Whatever text you
  654.                specify in this parameter will be used as the title
  655.                for the yes/no box.  If you do not specify a
  656.                parameter for this function, "Are You Sure" will be
  657.                used.  Note that you must surround your text with
  658.                quotation (") marks, and are limited to 40
  659.                characters.
  660.  
  661. /q             (Quiet Mode - Optional)  Do not clear the screen
  662.                when the program ends.
  663.  
  664. /c             (Color - Optional) Select a color from 1 -4
  665.  
  666.       LANTools Yesbox Returns the following DOS ERRORLEVELS
  667.  
  668.                1 = The "Yes" option was selected.
  669.                2 = The "No" option was selected.
  670.  
  671.                               ╒═══════╕
  672.                               │ Notes │
  673.                               ╘═══════╛
  674.  
  675. We are planning the following enhancements to LANTools:
  676.  
  677. 1.   Rolodex/Address Manager tied to EEMail's databases.
  678. 2.   Map Assistant
  679. 3.   Send/Receive Files between users.
  680.  
  681. If you have any ideas for enhancements, please let us know!  While
  682. we're here, here's a plug:  Try Einstein Electronic Mail!  You can
  683. find it on CIS, or on our support BBS.  You'll find the same easy-to
  684. use functions in a professional, friendly electronic mail program for
  685. Novell Networks.
  686.  
  687.                             ╒══════════════════╕
  688.                             │ Revision History │
  689.                             ╘══════════════════╛
  690.  
  691. Date           Version   Description
  692. =========================================================================
  693. 05-03-91       1.0       Initial Release
  694. =========================================================================
  695. 05-04-91       1.01      Changes to .DOC to show /c options,
  696.                          /r=REBOOT in LOGOUT was missing in code.
  697. =========================================================================
  698. 05-07-91       1.02      Missing multiple group checking in IsMember.
  699.                          Added Online help when running LANTools without
  700.                          parameters.
  701. =========================================================================
  702. 05-10-91       1.03      SEND now shows users who are logged on.  Also
  703.                          added some information when a user is selected
  704.                          to send a message.
  705.  
  706.                          Fixed a bug in MESSAGE that converted the text to
  707.                          lower case, and added code to allow up to two
  708.                          lines in most /m options.
  709. =========================================================================
  710. 06-08-91       1.04      Fixed minor interface bugs.  You'll probably not
  711.                          notice most of them, but they bugged me.  For
  712.                          instance, when selecting a user in SEND, the
  713.                          light bar is returned to that user after the
  714.                          message is sent.  Same kinda thing for CAPTURE.
  715. =========================================================================
  716. 06-17-91       1.05      Another maintenance release.
  717.                          This release, we worked on the CAPTURE command.
  718.                          Now the user's previous capture flags are used
  719.                          and displayed.  You'll notice the extra screens
  720.                          when the program is executed.
  721.  
  722.                          Another minor one, the color parameters were ignored
  723.                          in SEND and CAPTURE.  This is fixed.  Still have
  724.                          to work on the colors for /c=2,3 and 4.  They're
  725.                          pretty ugly right now...
  726. =========================================================================
  727. 06-21-91       1.10      Added a new function, PASSWORD.  This allows you
  728.                          to test your user's password.  If it close to
  729.                          expiring (within 3 days), PASSWORD will prompt
  730.                          your users for their password, and change it in
  731.                          the bindery.  This function is the only reason
  732.                          I can think of right now to own a laptop.  Instead
  733.                          of staring at the walls waiting for a plane, I was
  734.                          able to get some work done.  Now if only I had
  735.                          a cellular modem...
  736.  
  737.                          Another new one, MENU, allows you to create
  738.                          a bounce-bar menu.  Supply the file name containing
  739.                          the menu items, and go.  Returns a DOS ERRORLEVEL
  740.                          depending on the item selected.
  741.  
  742.                          SEND was totally changed in this release.  Now you
  743.                          can send messages to groups.  More information
  744.                          and cleaner interface.
  745.  
  746.                          SEND and CAPTURE received a "Scroll Bar" function.
  747.                          This helps the user tell where he is in the list
  748.                          of things.
  749.  
  750.                          CAPTURE had an invalid maximum window length,
  751.                          which "shadowed out" the userid in the footer
  752.                          line if more than 11 print queues were available.
  753.  
  754.                          LIST was changed a bit.  If you do not specify
  755.                          a file name (/f=filespec) on the command line,
  756.                          LIST will prompt you for one.
  757.  
  758.                          This version has also changed the way users are
  759.                          prompted for their password in some functions.
  760.                          Now, TIMEOUT and LOCK display "*" instead of
  761.                          displaying the text of the password.
  762.  
  763.                          If a user does not enter a message text in LOCK,
  764.                          a default of "I Am Away From My Desk" is now used.
  765.  
  766.                          The SAMPLE.BAT changed to add new functions.
  767.                          Re-Run this again to see what's new.  Edit that
  768.                          batch file to see how you can interface this
  769.                          stuff...
  770. =========================================================================
  771. 06-24-91       1.11      Maintenance Release (so soon, you ask?)
  772.  
  773.                          Everyone bugged me about not verifying the NEW
  774.                          password in PASSWORD.  That's been corrected.
  775.                          The user is asked to enter his new password
  776.                          twice in this function.  Also changed some
  777.                          messages the user receives when something
  778.                          happens to clarify the situation.
  779.  
  780.                          The User Listing Window box in SEND was 2 lines
  781.                          too long.  Woops.  Should have looked at the
  782.                          code for CAPTURE, it was the exact same.
  783. =========================================================================
  784. 06-30-91       1.20      New Version 1.20
  785.  
  786.                          Added another new function, WhoAmI.  This
  787.                          is sorta like the WHOAMI.EXE program that Novell
  788.                          provides, just a little deeper.  Basically combines
  789.                          some of the functionality of the Account
  790.                          Restrictions in SysCon, WHOAMI's display, and
  791.                          some other extras...
  792.  
  793.                          LOCK received a screen blanker.  After an
  794.                          inactivity period of about 5 minutes, the
  795.                          screen will go blank, and a spinner will appear
  796.                          in the lower right corner of your screen.  This
  797.                          will continue until a key is pressed.  Fixed
  798.                          a few minor interface problems in LOCK as well.
  799.                          For instance, when pressing the <Esc> key to
  800.                          type the password, if <Esc> is pressed again,
  801.                          LOCK does not display the "Invalid Password"
  802.                          message.
  803.  
  804.                          A problem in PASSWORD was fixed that caused the
  805.                          "Minimum Password" error box to remain on the
  806.                          screen.
  807.  
  808.                          The minimum password length no longer appears
  809.                          when typing the OLD password in PASSWORD.
  810.  
  811.                          Changed a parameter in PASSWORD that allows you
  812.                          to specify the drive:path\filename of the
  813.                          password log file.  For instance:
  814.  
  815.                          LANTools Password /f /l=g:\anything\new.dat
  816. =========================================================================
  817. 07-16-91       2.00      New Version 2.00
  818.  
  819.                          ATTACH did not work.  It probably never worked,
  820.                          but I did not hear anything about it, and there
  821.                          is just one server in our office so it went
  822.                          unnoticed.  This new version takes care of all
  823.                          the problems this program had.  In addition to
  824.                          the Bug fixes, the password field is blanked out
  825.                          like other password fields.
  826.  
  827.                          The most important feature of this new release
  828.                          is in the SEND and CAPTURE commands.  Both
  829.                          of these new commands now support multi-server
  830.                          environments.  If you need to capture to a
  831.                          printer on a different server, or send a
  832.                          message to a user on a remote server, you no
  833.                          longer need to make that your default server.
  834.  
  835.                          SEND now allows users with Supervisor
  836.                          equivalence to send "anonymous" messages.  This
  837.                          means that your user ID is not sent along with
  838.                          the message (just like BROADCAST from the
  839.                          file server).
  840.  
  841.                          CAPTURE received many other small changes, most
  842.                          have to do with Multi-Server environments.  Other
  843.                          changes include the ability to End Capture from
  844.                          any port (previously it selected only your default
  845.                          port).  Many Interface changes.
  846.  
  847.                          A new command, CheckPass has been added. This is
  848.                          a very simple utility that allows you to prompt
  849.                          the user for a password.  If entered correctly,
  850.                          a DOS ERRORLEVEL of 1 is returned.  Incorrect
  851.                          entries return a DOS ERRORLEVEL of 0.
  852. =========================================================================
  853. 07-16-91       2.01      Maintenance Release
  854.  
  855.                          A bug in SEND caused non-supervisor users to
  856.                          receive an error message after pressing the
  857.                          <Enter> key to send the message and return to DOS.
  858.                          This problem is now corrected...woops!
  859. =========================================================================
  860. 08-10-91       2.10      New Version
  861.  
  862.                          A typo disabled the Multi-Server functions.
  863.                          They're back!
  864.  
  865.                          PASSWORD got a few cosmetic changes.  For one,
  866.                          the opening screen displays a brief message
  867.                          about changing your password.  A bug in the
  868.                          date logic caused the program to ignore when
  869.                          a user's password was about to expire.  The
  870.                          program now checks the password expiration
  871.                          date, and if it's within 4 days, a prompt
  872.                          displays to change it..
  873.  
  874.                          The Yes/No dialog boxes would not accept the
  875.                          "Y" or "N" keys as valid responses.  They
  876.                          do now...
  877.  
  878.                          Is there anyone out there?  Please tell us if
  879.                          you like this program, or even if you don't.
  880.                          We'd like to know!
  881.  
  882. =========================================================================
  883.  
  884.                                ╒════════════╕
  885.                                │ Known Bugs │
  886.                                ╘════════════╛
  887.  
  888. No program is bug free.  We try to make programs that do their job, but
  889. some bugs inevitably crawl into programs.  That's a fact of life.  If you
  890. find a bug, please let us know so we can correct it.  The following is
  891. a list of bugs we know about and are working to correct:
  892.  
  893. ATTACH - In Netware 386, if you do not use the command "SET UNENCRYPTED
  894. PASSWORDS = OFF", ATTACH will not work.  I would not recommend that you
  895. set this option at the file server just to use ATTACH, since Netware's
  896. security may be compromised if you do.  If you are using pre 3.00 shells,
  897. or are using Netware 286 version 2.1x, then you are already allowing
  898. unecrypted passwords, and you will not notice this problem.  We are
  899. working on this one...
  900.  
  901. PASSWORD - In Netware 386, if you are using Encrypted Passwords, PASSWORD
  902. will not work.  Password will flag you that the server is encrypted,
  903. and the password will not be changed.  Basically same as ATTACH...
  904.  
  905.  
  906.                                  ╒════════╕
  907.                                  │ Notice │
  908.                                  ╘════════╛
  909.  
  910.               Netware is a trademark of Novell, Incorporated.
  911.      IBM is a trademark of International Business Machines, Incorporated.
  912.  All other trademarks mentioned are trademarks of their respective companies.
  913.